home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / stno_103.lzh / CHANGES.101 next >
Text File  |  1990-03-28  |  18KB  |  352 lines

  1.                             STeno Changes for 1.01
  2.                             ======================
  3.  
  4.  
  5. Paragraph Reformatting
  6. ----------------------
  7.  
  8. Without a doubt the most-requested enhancement has been the ability to
  9. reformat paragraphs.  This has been added, and works similar to the way
  10. Word Writer and 1ST Word handle reformatting, ie. just move the insertion
  11. point to the first line of a paragraph and hit F10.  There is even a
  12. "Reformat to End" command which will reformat all of the text from the
  13. insertion point to the end of the file.
  14.  
  15. The important point to note about reformatting is that the indent level is
  16. based on the *second* line of the paragraph.  Actually, the line after the
  17. cursor is used to determine the indent level, so if you press F10 with the
  18. cursor in the middle of a paragraph you'll find that the rest of the
  19. paragraph is formatted according to the indent level of the line after the
  20. one you started on.  This allows you to easily have both indents and
  21. outdents without having to resort to special types of tabs like Word Writer
  22. ('indent' vs. 'tab').
  23.  
  24. For reformatting purposes a 'paragraph' is considered to be a sequence of
  25. non-blank lines.  A line which contains only blanks or tabs is considered
  26. to be a blank line.
  27.  
  28. The right margin is taken from the current word wrap column, so you can
  29. vary your right margins simply by altering the wrap column as you reformat.
  30.  
  31. Fully justified text is not currently supported for 2 reasons.
  32.  
  33. 1   Justified text *without* proportional typefaces or micro-spacing 
  34.     between characters and words is, for most people, harder to read than
  35.     text which is "ragged right".  This is due to the fact that extra
  36.     blanks are inserted between words in order to make a flush right
  37.     margin, which causes the inter-word spacing to vary within a single
  38.     line.  Using a proportional typeface or a non- proportional typeface
  39.     with microspacing allows the padding to be distributed evenly between
  40.     all of the words and characters in the line, resulting in consistent
  41.     inter-word spacing and much more readable text.  Just to prove my
  42.     point, check out the paragraph for reason #2.  It didn't turn out all
  43.     that horrible, but imagine how much of a pain it would be to read if
  44.     all of its lines were as bad a the third one.  Yeah, I know.... this is
  45.     basically my way of saying "nahhhh, I don't really want to bother doing
  46.     that".
  47.  
  48. 2   STeno  deals with pure-ASCII files, and there is no foolproof way 
  49.     to  handle justified  paragraphs properly  with pure-ASCII files.  
  50.     The  problem  arises  when  you  decide  to reformat  a justified 
  51.     paragraph.  If extra ASCII blank characters were used in order to 
  52.     fill lines, then many words would have two or more blanks between 
  53.     them  and STeno  wouldn't be  able to  tell which  ones were  the 
  54.     'real' ones.  Some editors solve this by reducing multiple blanks 
  55.     to  single blanks  and then  apply some typical  formatting rules 
  56.     putting  two  blanks  after  periods,  question  marks, etc.   Of 
  57.     course,  if  you  didn't  want  to  have  two blanks  after those 
  58.     characters you'd have to go and manually fix things up again, and 
  59.     any  tables or other special alignment  you used blanks for would 
  60.     be pretty much wrecked.
  61.  
  62.     The way around this of course is to use some special character rather
  63.     than an ASCII blank to represent the inserted spaces, but saving such a
  64.     character would produce a file that is not pure ASCII, and would
  65.     probably not be too readable from the desktop.  Since STeno uses plain
  66.     old ASCII this is not an acceptable solution.
  67.  
  68.  
  69. Printer Setup
  70. -------------
  71.  
  72. There is a new "Printer Setup..." command under the File menu.  Selecting
  73. this brings up a new dialog which allows you to set several options which
  74. control the way STeno prints:
  75.  
  76. o   The Printer Initialization String is simply a sequence of characters
  77.     that STeno will send to the printer at the beginning of a "Print" or
  78.     "Print Selection" command.  You can enter up to 35 characters on this
  79.     line; what you put, if anything, will depend on your printer.  Most
  80.     printers use different escape sequences to select things like the font
  81.     type and pitch - check your printer manual to find out what you need to
  82.     use.
  83.  
  84.     Since the dialog uses a standard GEM text entry field there are a 
  85.     couple of things to point out.  You can't enter a 'null' character
  86.     (ASCII value of 0) since that character is used by GEM (and STeno) to
  87.     terminate the string itself.  Fortunately most printers will accept
  88.     either null or the '0' character interchangeably.  The other quirk is
  89.     that the commercial at sign '@' cannot be used as the first character
  90.     in the string.  If GEM sees '@' as the first character it automatically
  91.     considers the entire string to be empty.  This was probably done as a
  92.     convenience for programmers when creating dialog boxes, but turns out
  93.     to be more of a hindrance than a help.  You'll notice this in *any* GEM
  94.     dialog text fields that allow arbitrary text (you won't see it in
  95.     places that allow only digits or filename characters however), so it
  96.     has nothing to do with STeno.
  97.  
  98. o   The Left Margin Offset field lets you specify how many blanks to add to
  99.     the beginning of each line sent to the printer.
  100.  
  101. o   The Print Page Banner box determines whether or not STeno will print a
  102.     three line banner at the start of each page.  The first line will
  103.     contain the file name, the current date, and the page number.  Lines
  104.     two and three are left blank to separate the banner from the file data.
  105.  
  106. o   The Send LF after CR box tells STeno to send either a carriage return /
  107.     linefeed pair after each line or just a carriage return. If your
  108.     printer is configured for automatic line feeds after carriage returns
  109.     then make sure this box is off (white).
  110.  
  111. o   The Lines Per Page entry tells STeno the *total* number of lines 
  112.     available on each page.  Subtract 6 from this number to determine the
  113.     number of lines STeno will print the file data on.  Three lines are
  114.     used at the start of the page for the banner and three are left at the
  115.     bottom of the page in order to skip over the page break.  Naturally,
  116.     STeno won't let you set this number to less than 7.
  117.  
  118.     Setting the Lines Per Page to 0 effectively sets up an infinitely 
  119.     large page.  You'll get the banner at the beginning of printing if it's
  120.     enabled, but you won't get any other blank lines inserted during
  121.     printing.
  122.  
  123. o   The Use FF To Eject Page box tells STeno whether or not it should send
  124.     an ASCII form-feed character (value 12) to go to the next page or
  125.     simply enough blank lines to reach the Lines Per Page total.  Virtually
  126.     all printers understand the form-feed character, and it usually gets
  127.     you to the next page much more quickly than a bunch of blank lines.
  128.  
  129. o   Eject Last Page determines if STeno will stop after the last line has
  130.     been printed or advance the paper to the beginning of the next page.
  131.  
  132.  
  133. The Accessory Title Changes!
  134. ----------------------------
  135.  
  136. The accessory title in the GEM "Desk" drop-down menu will now show "STeno:
  137. <filename>", where <filename> is either "Untitled" or the name of the
  138. current file.  This is the same information that STeno uses for the window
  139. title and is a really nice way to see what file you have loaded, especially
  140. if you like to load multiple STenos.
  141.  
  142. Since GEM limits desk accessory titles to 20 characters, the extension
  143. portion of the filename will not be shown if the title would exceed 20
  144. characters.  For example, "  STeno:  DESKTOP.INF" just fits (all
  145. accessories put 2 blanks at the beginning), but a long file name such as "
  146. STeno:  FILENAME.EXT" is too big, so STeno just shows:  "  STeno:  
  147. FILENAME".
  148.  
  149. Those of you who are using STeno from within MultiDesk will just see
  150. "STeno", since MultiDesk makes its own copy of the original name used and
  151. STeno's changes go unnoticed.
  152.  
  153.  
  154. STENOCFG.TTP Is Now Obsole